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Demo 1 : Simple Sound Generator 





Block-Diagram Algebra 

Faust syntax is based on a block diagram algebra 


5 Composition Operators 

■ (A,B) parallel composition 

■ (A:B) sequential composition 

■ (A<:B) split composition 

■ (A:>B) merge composition 

■ (A~B) recursive composition 

2 Constants 

■ ! cut 

■ _ wire 
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Block-Diagram Algebra 

Parallel Composition 


The parallel composition ( A,B ) is probably the simplest one. It places the 
two block-diagrams one on top of the other, without connections. 


- process 



Figure: Example of parallel composition (10,*) 
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Block-Diagram Algebra 

Sequential Composition 


The sequential composition (A : B ) connects the outputs of A to the inputs 
of B. /\[0] is connected to [0]B, /4[1] is connected to [1]B, and so on. 



Figure: Example of sequential composition ((*,/):+) 
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Block-Diagram Algebra 

Split Composition 


The split composition ( A<\ B ) operator is used to distribute the outputs of 
A to the inputs of B 



Figure: example of split composition ((10,20) <: (+,*,/)) 
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Block-Diagram Algebra 

Merge Composition 

The merge composition (A :> 6) is used to connect several outputs of A to 
the same inputs of B. 



Figure: example of merge composition ((10,20,30,40) :> *) 
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Block-Diagram Algebra 

Recursive Composition 


The recursive composition (A~B) is used to create cycles in the 
block-diagram in order to express recursive computations. 



Figure: example of recursive composition +(12345) ~ *(1103515245) 
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Same expression in Lambda-Calculus, FP and Faust 
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Same expression in Lambda-Calculus, FP and Faust 


Lambda-Calculus 

\x.\y.(x+y,x*y) 2 3 

FP/FL (John Backus) 
[+,*]:<2 , 3 > 

Faust 

2,3 <: +,* 



Figure: block-diagram of 2,3 <: + 
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Demo 2 : Parallelization 
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Faust Modular Architecture Files 

DSP code 



To provide easy deployement, the DSP code generated by compiling a 
Faust program should be pure audio computation, abstracted from any 
audio drivers or GUI toolkit. 
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Faust Modular Architecture Files 

DSP class 



class dsp { 
protected: 

int fSamplingFreq; 
public: 
dsp() {} 

virtual ~dsp() {} 


virtual int getNumlnputs () = 0; 
virtual int getNumOutputs () = 0; 
virtual void buiIdUserInterface(UI* interface) = 0; 
virtual void init(int samplingRate) = 0; 
virtual void compute(int len, float** inputs, float** outputs) = 0; 

}; 
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Faust Modular Architecture Files 

Audio driver and User Interface modules 


User Interface 

Module 


V 

> 



> 

Audio Driver Module 


The role of the architecture file is to provide the missing information: the 
audio drivers and the user interface. The new modular architecture file 


combines an Audio driver module and one or more User Interface modules. 

<■£►<=► 1 - 00,0 
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Faust Modular Architecture Files 



User Interface 
Module 




> 

Audio Driver Module 


The Faust compiler wraps the DSP code into the selected architecture file. 
For examples faust -a jack-gtk.cpp noise.dsp will wrap the dsp code 
of a noise generator into the architecture of jack-gtk standalone application. 
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Faust Modular Architecture Files 

The Audio Class 



class audio { 
public : 

audio () {} 
virtual ~audio() {} 

virtual bool init(const char*, dsp*) = 0 
virtual bool start() = 0 

virtual void stop () = 0 
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Faust Modular Architecture Files 

The User Interface Class 


class UI 

{ 

public: 


UIO { } 

virtual ~UI () { } 


virtual 

virtual 

virtual 

virtual 

virtual 


void openFrameBox(const char* label) = 0; 
void openTabBox(const char* label) = 0; 
void openHorizontalBox(const char* label) 
void openVerticalBox(const char* label) = 
void closeBoxQ = 0; 


= 0 ; 


0 ; 


virtual 

virtual 

virtual 

virtual 

virtual 

virtual 


void addButton(const char* label, float* zone) = 0; 
void addToggleButton(const char* label, float* zone) = 0; 
void addCheckButton(const char* label, float* zone) = 0; 
void addVerticalSlider(const char* label, float* zone, ...) = 
void addHorizontalSlider(const char* label, float* zone, ...) 
void addNumEntry(const char* label, float* zone, ...) =0; 


0 ; 


= 0 ; 


virtual 

virtual 

virtual 

virtual 


void addNumDisplay(const char* label, float* zone, int precision) = 0; 
void addTextDisplay(const char* label, float* zone, const char* names[], 
void addHorizontalBargraph(const char* label, float* zone, ...) = 0; 
void addVerticalBargraph(const char* label, float* zone, ...) = 0; 


}; 


virtual 


void declare(float* 


const char* 


const char* ) {} 
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Faust Modular Architecture Files 


The jack-gtk architecture 


int main(int argc, char *argv[]) 

{ 


char appname [256]; 

char refilename [256]; 


char* home = getenv("HOME"); 

snprintf (appname , 255, basename (argv [0] ) ) ; 

snprintf(refilename, 255, "Xs/,Xsrc", home, appname); 

DSP = new mydspO; 
if (DSP==0) { 

cerr << "Unable u to u allocate u Faust u DSPuObject" << endl; exit(1); 


} 


GUI* interface = new GTKUI (appname, &argc, &argv); 
FUI * f interface = new FUIO; 

GUI* oscinterface = new 0SCUI(appname, argc, argv); 

DSP-> buildUserlnterface(interface); 

DSP-> buildUserlnterface(finterface); 

DSP->buildUserlnterface(oscinterface); 

jackaudio audio; 

audio.init(appname, DSP); 

finterface->recallState(rcfilename); 

audio.start(); 

oscinterface->run (); 

interface->run(); 

audio.stop(); 

finterface->saveState(rcfilename); 
delete DSP; 
return 0; 



} 
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Demo 4 : OSC support 
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Automatic Mathematical Documentation 

Motivations et Principles 


■ Binary and source code preservation of programs is not enough : quick 
obsolescence of languages, systems and hardware. 

■ We need to preserve the mathematical meaning of these programs 
independetly of any programming language. 

■ The solution is to generate automatically the mathematical description 
of any Faust program 
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Automatic Mathematical Documentation 

Tools provided 


■ The easiest way to generate the complete mathematical 
documentation is to call the faust2mathdoc script on a Faust file. 

■ This script relies on a new option of the Faust compile : -mdoc 

■ faust2mathdoc noise.dsp 
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Automatic Mathematical Documentation 

Files generated by Faust2mathdoc noise.dsp 


T noise-mdoc/ 

T cpp/ 

❖ noise.cpp 
T pdf/ 

❖ noise.pdf 
T src/ 

o math.lib 
o music.lib 
o noise.dsp 

▼ svg/ 

o process.pdf 
o process.svg 

▼ tex/ 

o noise.pdf 
o noise.tex 


Y. Orlarey, K. Barkati, D. Fober, S. Letz (' 


What's new in Faust 





Automatic Mathematical Documentation 

Tags 


■ The documentation can be generated fully automatically from a 
regular Faust program. 

■ It can also be controled by embedding documentation statements in 
Faust programs. 

■ A documentation statements starts with an opening <mdoc> tag and 
ends with a closing </mdoc> tag. 

■ It contains arbitraty text, typically in lAT^X format, as well as five 
sub-tags : 

► <diagram> 

► <equation> 

► <metadata> 

► <notice/> 

► <listing/> 
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Automatic Mathematical Documentation 

Diagram tags 


r diagram_0 


r process - - 
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Automatic Mathematical Documentation 

Diagram tags 


■ The generation of the graphical block-diagram of a Faust expression 
can be requested using <diagram>. . .</diagram> tags. 


r diagram_0 
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Diagram tags 


■ The generation of the graphical block-diagram of a Faust expression 
can be requested using <diagram>. . .</diagram> tags. 

■ For example: <diagram> +~_ </diagram> will produce the embedded 
diagram: 


r diagram_0 
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Automatic Mathematical Documentation 

Diagram tags 


■ The generation of the graphical block-diagram of a Faust expression 
can be requested using <diagram>. . .</diagram> tags. 

■ For example: <diagram> +~_ </diagram> will produce the embedded 
diagram: 


Expression diagram 




r diagram_0 

i 


i 

i 

r process - - 

i 

i 


i 

i 

D 

i 

D ^ 

i 

i 

I 

i 

i 


1 >00,0 
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Automatic Mathematical Documentation 

Equation tag 


■ The generation of the mathematical equations of a Faust expression 
can be requested using <equation>. ..</equation> tags. 

■ For example: <equation> +~_ </equation> will produce the 
following description: 


Output signal y such that 


y ( 0|*(0 


■ Input signal x 

■ Intermediate signal r x such that 

ri(t)==x(t) + ri(t-l) 
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Automatic Mathematical Documentation 

Equation tag 


n The generation of the mathematical equations of a Faust expression 
can be requested using <equation>. . .</equation> tags. 

■ For example: <equation> +~_ </equation> will produce the 
following description: 

Expression equations 

■ Output signal y such that 

y(t) = r i(0 

■ Input signal x 

■ Intermediate signal r 1 such that 

ri (t)=x(t) + ri {t-l) 
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Automatic Mathematical Documentation 

Metadata tags 


■ The <metadata>. . .</metadata> tags allow to refer Faust metadatas 
declarations 

■ For example if the Faust code declares: 
declare author "Albert"; 

■ then occurences in the documentation of: 
<metadata>author</metadata> 

■ will be replaced by: "Albert". 
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Automatic Mathematical Documentation 

Notice tag 


■ The <notice/> empty-element tag is used to generate the 
conventions used in the mathematical equations. 
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Automatic Mathematical Documentation 

Listing tag 

■ The <listing/> tag is used to generate the listing of the Faust 
program. 

■ It can be customized with three boolean attributes that can take the 
value true or false: 

► mdoctags when true (the default) indicates to include the mdoc comments 
into the listing. 

► dependencies when true (the default) indicates to include the code of the 
imported libraries into the listing. 

► distributed when true (the default) indicates to respect the distribution 
of faust code and mdoc tags. 


<listing mdoctags="true" 

dependencies 11 " false" 
distributed="false" /> 
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■ The <listing/> tag is used to generate the listing of the Faust 
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Automatic Mathematical Documentation 

Listing tag 

■ The <listing/> tag is used to generate the listing of the Faust 
program. 

■ It can be customized with three boolean attributes that can take the 
value true or false: 

► mdoctags when true (the default) indicates to include the mdoc comments 
into the listing. 

► dependencies when true (the default) indicates to include the code of the 
imported libraries into the listing. 

► distributed when true (the default) indicates to respect the distribution 
of faust code and mdoc tags. 


Example 

<listing mdoctags="true" 

dependencies="false" 
distributed="false" /> 


Y. Orlarey, K. Barkati, D. Fober, S. Letz ( 


What's new in Faust 


May 2011 35 / 42 






Demo 5 : 


Y. Orlarey, K. Barkati, D. Fober, 


Documentation 


I. Letz ( 


What's new in Faust 


< 1 ► 1 - 00,0 

May 2011 36 / 42 




Using FAUST Online Compiler 
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Resources 

Using FAUST Online Compiler 



■ http://faust.grame.fr 
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Using FAUST Online Compiler 
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Resources 

Using FAUST Distribution on Source Forge 
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tests tools windows COPYING Makefile [README! WHATSNEW 



git clone 

git://fa udiostream.git.sourceforge.net/gitroot/faudiostream/faudiostrearr 
faust 


■ cd faust; make; sudo make install 
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faust 


cd faust; make; sudo make instal 
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Resources 

Using FaustWorks IDE 



b Q 13 j Binary ; tlackgdi ; || No opOons 



■ git clone 

git://fa udiostream.git.sourceforge.net/gitroot/faudiostream/FaustWorks 

■ cd FaustWorks; qmake; make 
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Resources 

Books with a FAUST related content 


Introduction to 
Digital Filters 

WITH AUDIO APPLICATIONS 


JULIUS O. SMITH III 


Figure: «Introduction To Digital Filters with Audio Applications », prof. Julius 0. 
Smith III, W3K publishing 
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Resources 

FAUST Introduction 


mummi 



Figure: «Audio Signal Processing in Faust», Julius 0. Smith III, CCRMA, Stanford 
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Resources 

FAUST Quick Reference 


FAUST Quick Reference 



Figure: «Faust Quick References, Grame 
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